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Overview 



•Description 

/Provides the ability to configure 
major components of TCP/IP for 
OS/2 








Overview - Features 



Network Tab 
Amptn\bin\setup.cmd 
/etc\dhcpcd.cfg 
/OS/2 System startup folder 

Routing Tab 

Amptn\bin\setup.cmd 

Hostnames Tab 
Aconfig.sys 
Aetc\resolv2 
Aetc\hosts 
Aconfig.sys 

Autostart Tab 

Atcpip\bin\tcpstart.cmd 

General Tab 

Aconfig.sys 
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Overview - Features 

(continued) 

— 

•Security Tab 
Aconfig.sys 
Aetc\trusers 
Aetc\rhosts 
Aetc\tftpauth 

•Servers Tab 

Aetc\tcpos2.ini 

•Socks Tab 

Aetc\socks.env 

Aetc\socks.cfg 

•Printing Tab 
Aconfig.sys 
Aos2\os2.ini 
Aos2\os2sys.ini 

•Mail Tab 

Aetc\tcpos2.ini 

Aetc\*\mailstor directory moved 









Overview - Features 

(continued) 

— 

•Sendmail Tab 
Aetc\sendmail.cf 
Aetc\sendmail.uml 
Aetc\tcpos2.ini 









Features new with 
Merlin 



•SOCKS Tab 
/3 pages 

-page 1 writes configuration data 
to socks.env 

-pages 2 & 3 write configuration 
data to socks.cfg 
•Variable subnet routing 
/one field added to Routing page 

-Subnet mask can be entered for 
all routes except default route 









Limitations 

Dependencies 


•must have a dll present in order for 
tab to appear 

•must have all corresponding help 
(\tcpip\help\cnb*.hlp) files present for 
each dll (\tcpip\dll\cnb*.dll) in order 
for any help to work 



Installation 



•The following executable 

configuration files are installed: 

ztcpcfg.exe 

zcnbdns.dll 

zcnbgen.dll 

zcnbiak.dll 

/cnbprt.dll 

/cnbserv.dll 

/cnbsmail.dll 

/cnbsocks.dll 

/cnbstk.dll 

•...along with the following help files: 
ztcpipcfg.hlp 
zcnbdns.hlp 
zcnbgen.hlp 
zcnbiak.hlp 
zcnbprt.hlp 
zcnbserv.hlp 
/cnbsmail.hlp 
zchbsocks.hlp 
zchbstk.hlp 



Configuration & Setup 



•Installation program places: 
ztcpcfg.exe in \tcpip\bin 
/all cnb*.dll in \tcpip\dll 
/all cnbMilp in \tcpip\help 
/tcpipcfg.hlp in \tcpip\help 

•tcpcfg.exe must be in a directory 
specified in the PATH= statement in 
CONFIG.SYS 

•cnb*.dll files must be in a directory 
specified in the LIBPATH= statement 
in CONFIG.SYS 

•cnb*.hlp files must be in a directory 
specified in the HELP= statement in 
CONFIG.SYS 




Invocation & Startup 



•To start the configuration notebook: 
/dick on the TCP/IP Configuration 
(LAN) icon located in the Internet 
(LAN) folder 

/type tcpcfg on an OS/2 command 
line (window or fullscreen) 




Error Messages, Codes 
& Logs 



•all error/informational messages are 
displayed in popup boxes 

/messages extracted from country's 
message files, e.g.: 

-enus\cnb*.msg 

-dede\cnb*.msg 

-etc... 

/some error checking done at the 
entry field level 

/some error checking done at the 
page level 

/some error checking done when 
program is closed 

/action to take 

•Error log generated when the 
configuration notebook is started with 
-d option 

ztcpcfg -d 

/generally stated from the command 
line as opposed to from the icon 

/log is generated in the directory 
where tcpcfg was started 




Common User 
Problems 



•Help not available 

/each *.dll must have an 
accompanying *.hlp file 
•TABS missing from config notebook 
/dll is missing/corrupted 
•notebook will not start 

/probably due to backlevel 
tcpcfg.exe 

-2.0 CSD placed on top of 
Merlin?? 



Debugging & 
Troubleshooting 



•A log file of configuration transactions 
can be created by invoking tcpcfg 
with the -d option, e.g.: 

/tcpcfg -d 

/the file (tcpcfg.log) will be created 
and placed in the directory from 
which tcpcfg was started. 

•Debugging info: 

/depending on what type of problem 
the user is having, any of the files 
listed under "Features" could be 
useful. 



Source Overview 


•All source code in CMVC 
/family: wstcp 
/release: os2apps32 
/components: 

-os2tcpcfg: 

: driver (tcpcfg.exe) which starts 

the notebook 



-os2cnbdns 
: Hostnames Tab 

-os2cnbgen 

: Autostart & General Tabs 

-os2cnbiak 
: Servers Tab 

-os2cnbmail 
: Mail Tab 


-os2cnbprt 
: Printing Tab 



Source Overview 
(continued) 



-os2cnbserv 
: Security Tab 

-os2cnbsmail 
: Sendmail Tab 

-os2cnbstk 

: Network & Routing Tabs 

-os2cnbsocks 
: Socks Tab 



